home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 14 / CU Amiga Magazine's Super CD-ROM 14 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-09].iso / CUCD / Programming / IEditor / Docs / Expanders.txt next >
Text File  |  1997-06-17  |  3KB  |  105 lines
  1. If you want to know more about expanders, this doc is for you.
  2.  
  3. I'm writing a better documentation, but in the meantime read this and  the
  4. examples... ;-)
  5.  
  6.  
  7. Expanders, what are they?
  8. =========================
  9.  
  10. Well, they're shared libraries that can give IE the  ability  of  managing
  11. almost every object you could want to use in your GUI.
  12.  
  13. So far, they're in the "experimental stage": that means only that  I  have
  14. not  tried  very  much  them...  ;-)  By now I've just wrote three modules
  15. (described below), but since they work, I've decided  to  insert  them  in
  16. this release. :)
  17.  
  18. Anyway, I'm going to write some expanders  which  you're  going  to  like.
  19. Honest. ;-)
  20.  
  21.  
  22. If you write a new expander, I will be very glad if you could send me  it:
  23. by  snail  mail  or  uuencoded by e-mail (of course, if you write a 200 Kb
  24. one, don't even think about sending it that way ;-).
  25.  
  26. Anyway, if you start from the source of the ones I've made, you'll be able
  27. to create a new expander in about 5 minutes. B-)
  28.  
  29.  
  30. NOTE WELL: when writing a new IEX module, be sure to use 37  (or  a  number
  31. lower  than  that)  as  main  version number! If some new functions will be
  32. requested in the expander, IE will check if the version of the IEX is >=38!
  33.  
  34.  
  35. Some notes on xxx.desc files
  36. ============================
  37.  
  38. Reading the sources, you can easily infer  that  the  directives  used  in
  39. xxx.desc files are all defined by the expander (except for ##end).
  40.  
  41. That means that every expander can have its own directives. Anyway,  you'd
  42. better use these standard names:
  43.  
  44. RENDPRI
  45. Render priority. *Compulsory* for ALL objects which need rendering.
  46. IE's internal objects have priority = 0.
  47.  
  48. GLOBAL
  49. Global variables.
  50.  
  51. DATA
  52. Objects' data.
  53.  
  54. SUPPORT
  55. Support routine(s).
  56.  
  57. SUPPORT-FA
  58. Font-Adaptive support routine(s).
  59.  
  60. HEADER
  61. Stuff to be written in the .h file.
  62.  
  63. RENDER
  64. Rendering instructions.
  65.  
  66. INCLUDE
  67. Include files needed.
  68.  
  69. ...
  70.  
  71.  
  72.  
  73. As to the formatting codes, you could use these:
  74.  
  75. %o  -   Object label
  76. %w  -   Window label
  77. %x  -   Left Edge
  78. %y  -   Top Edge
  79. %W  -   Width
  80. %h  -   Height
  81. %f  -   Freedom
  82. ...
  83.  
  84.  
  85.  
  86. --------------------------------------------------------------------------
  87.  
  88. This is a short description of the expanders shipped with IE:
  89.  
  90. Gauge.iex: with this expander, you can add&use in a very simple way
  91.        fuel-gauges in your programs. Thanks to Gian Maria Calzolari
  92.        for its original source.
  93.  
  94. BackFill.iex: do you like the backfill of ReqTools requesters?
  95.           Well, you can add it just with a click of your mouse... ;)
  96.  
  97. BevelFill.iex: (to be used with BackFill.iex)
  98.            Useful to build beautiful requesters.
  99.  
  100.  
  101. You can see an example of these expanders in the "IEXTest.gui" file.
  102.  
  103. Have fun,
  104.      Wiz
  105.